6.1.3 创建OTC代付订单

#简要描述： 通过OTC实现法币提款

• 请求方式: POST
• 请求接口: https://网关域名/wallet-trade-merchant/v1/otc/payment/create
• 请求媒体类型( JSON 数据格式 )Content-Type: application/json

请求参数

参数名称	类型	必填	参数含义	参数说明
key	string	是	商户 key	apiKey
localOrderId	string	是	商户平台本地订单号	商户平台本地生成唯一订单号
localUserId	string	否	商户平台本地用户ID	商户平台本地用户ID
notifyUrl	string	否	回调地址	下单处理成功后，由 API 回调通知商户的地址（回调详情说明在最下方）
currency	string	是	提款币种	默认 CNY
amount	number	是	提款金额	可自定义定额（不能享受渠道费折扣，默认此订单交易速度为NOW）或者通过文档6.1.2接口获取下单金额（此金额可享受渠道费折扣） 可精确至两位小数
method	string	是	收款方式	ALIPAY（支付宝）、UNIONPAY（银联卡）、WECHAT（微信）、DIGITAL_RMB（数字人民币）
paymentData	json	是	收款信息	可参照下方代码请求样例
└payee └accountId ｜ └payee └accountId ｜ └cardNo └payee └bankName ｜ └payee └walletCode	string	是	payee （收款人姓名）、accountId（收款账号）、cardNo（银行卡号）、bankName（银行名称）、walletCode（数字人民币编码）	参数示例： 支付宝收款参数 { "payee":"柯南","accountId":13888888888} 微信收款参数 { "payee":"柯南","accountId":13888888888} 银联卡收款参数 { "payee":"柯南","cardNo":13888888888,"bankName":"中国银行"} 数字人民币收款参数 { "payee":"柯南","walletCode":13888888888}
speed	string	是	交易速度	可通过文档6.1.1接口获取(如果为NOW的话，代表此订单不会进入匹配池，会被运营直接手动处理)
sign	string	是	签名	详情见签名算法

请求 json 样例

{
  "key": "dNNTJZpgFVWlYrVv",
  "localOrderId": "899952123",
  "localUserId": "4114",
  "notifyUrl": "http://127.0.0.1:8080/merchant-demo1/notify/test",
  "currency": "CNY",
  "amount": 100,
  "method": "UNIONPAY",
  "paymentData": {
                    // 银联卡
                    "payee":"柯南",
                    "cardNo":13888888888,
                    "bankName":"中国银行"
                   
                   //  支付宝
                   // "payee":"柯南",
                   // "accountId":13888888888
                   
                   //  微信
                   // "payee":"柯南",
                   // "accountId":13888888888
                   
                   //  数字人民币
                   // "payee":"柯南",
                   // "walletCode":13888888888                
                  },
    "speed": "NOW",
    "sign":"c6e3c292bb8cafaea50d4001185e6112"
}

响应示例

{
  "code": 0,
  "success": true,
  "message": null,
  "data": {
  。        "orderId": 415236189438341,
            "localOrderId": "899952123"
           }
}

响应data 参数说明

参数名称	类型	参数含义
orderId	Long	订单号
localOrderId	string	商户平台自定义订单号

回调详情说明

回调的方式是：POST application/json

回调参数 json 示例

{ 
   "amount":"100",
   "currency":"CNY",
   "localOrderId":"8999521232121336",
   "merchantId":302992856974,
   "merchantUserId":"4114",
   "notifyTime":1766134282162,
   "orderCreateTime":1766133956739,
   "orderId":"423044353278405",
   "status":"SUCCESS",
   "sign":"563eabc8cff14e401d426ff385b643ba",
   "key":"9yUreYgTRtit39Dy"
}

参数名称	类型	参与签名	参数含义	参数说明
amount	decimal	是	订单金额
currency	String	是	币种
localOrderId	String	是	本地订单号
merchantId	Long	是	商户号
merchantUserId	String	是	商户的用户ID
notifyTime	Long	是	回调时间
orderCreateTime	Long	是	订单创建时间
orderId	String	是	订单号
status	String	是	代付状态	SUCCESS:已完成 | FAIL:已失败
sign	String	否	md5 签名	详情请看签名算法
key	String	是	api key

当您收到回调通知后，请在处理完成后直接返回字符串 success，表示已成功接收并处理该消息。 系统在收到 success 响应后，将不再对该笔回调进行重复发送。 若未收到期望响应（未返回 success 或返回异常），系统将按照阶梯式重试机制重新发送回调通知，最多重试 14 次。 当前重试时间间隔依次为： 15s, 15s, 30s,180s, 600s, 1200s, 1800s, 1800s, 1800s,3600s,10800s,10800s,21600s, 21600s